by Thames Television, The Sunday 


QL, software 


win awards 


month. — : 
The prestigious awards, sponsored 


Times and VNU Business Publications 
(publishers of Personal Computer 

‘orld and What Micro?), were given 
to representatives o: Sinclair and 
Psion (who wrote the software). The 
QL was given Personal Computer 
World’s award as ‘Home Computer of 
the Year’ (beating the Amstrad and 
MSX computers, which were also no- 
minated in the category), while Psion’s 
QL software earned it the title of 
‘Home Software of the Year.’ 

It was the crowning achievement in a 
year which has seen much activity in 
connection with both the QL and its 


The QL and the four business software packages’ included 
_ with it— QL Quill, Abacus, Archive and Easel - won awards _ 
for excellence at the British Microcomputing Awards last 


popular software. For example, Psion 
announced late last year that the power- 


ful QL software suite would soon be 
available in an integrated form for the 
IBM PC and ACT Apricot computers 
under the name ‘Xchange’. The pro- 
gramming languages and user inter- 
face on the QL ae IBM/ACT versions 
are the same, so that programs written 
in the Archive database language will 
run on the PC. 2 


The Xchange software earned Psion a 
nomination for the ‘Business Software 
of the Year award.’ The winner in this 
eategory had not yet been announced at 
press time. 
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New QL magazine and peripherals 


QLUB News has negotiated a deal which will result in all and offer al the tect you would oe 
sos : * ect Ol a Nigh-qua ot-matrix printe! 
QLUB members receiving a new QL magazine free for six Mth {.0 additional faclity of offering a 


months. 


The new magazine, QL World, is 
being distributed along with QLUB 
News for six months and will further 
expand the information offered to 
members by QLUB and QLUB News. 
Your free limited subscription to QL 
World is the result of a deal negotiated 
on your behalf by Sinclair with the 
publishers of QL World. 

This means that every issue you'll 
get up to 60 pages of news, views and 
how-tos for your QL - in addition to 
your regular QLUB News. The deal 
with QL World is part of an on-going 
effort by Sinclair Research to improve 


and expand support for the machine. 


Every issue of QLUB News will 
continue to offer a wide breadth of infor- 
mation on or about the QL. Meanwhile, 
the first issue of QL World is distributed 
with this issue of QLUB News — and the 
details of the scheme are explained in 
the Editor’s message on page 2. 


Sinclair Research will shortly be laun- 
ching a dedicated printer for use with 
the QL. It will be produced in QL black 


Ssimcisair! 


superior typeface with its Near Letter 
Quality mode (more details are available 
on Page 4). 

The printer can be used with the four 
Psion sofware packages which come 
with the QL so that, for example, busi- 
ness letters produced in QL Quill 
can be printed using the Near Letter 
Quality mode with your own headed 
stationery. 

In addition to the printer, Sinclair has 
almost completed an agreement with 
Micro Peripherals for the supply of 
Sinclair-brand 3.5 inch disk drive and 
disk interface systems for the QL (again 
details can be found on Page 4). 


By now you're probably wondering why 
you've got an extra magazine with this issue 
of QLUB News — and how that happy state 
of affairs came to be. 


Part of this is explained in our news story 
on Page 1, but the rest will be detailed here. 
QL World is the latest new magazine 
devoted exclusively to users of the Sinclair 
QL and Sinclair have negotiated a deal 
for QLUB members whereby you can 
receive the new magazine free for a limited 
period. 


Our oe ee World were 
partly prompte our desire to satisfy a 
demand from you - the QLUB readers - for 
more and more information about the QL. 
The new arrangements not only give you 
QLUB News — with all its regular features 


Printer 
Problems 


~ Tam using version 1.01 ADB of Easel which 


‘was provided with the purchase of my Sin- 
clair QL. The printer driyer provided on 
this version of QL Easel is for the FX 80 
Printer of Epson. 

T am using an Epson FX 100 printer and 
the printer driver does not work. Could you 
de inform me if there is another printer 

river for this programme available and if 
so where I could get it, or how the existi 
driver can be modified to suit my printer? 
J Stacher 


Editor's reply: A larger number of printers 


ave supported in. the Version 2 Psion sof- 


tware for QL Easel, Abacus, Archive and 

ee And your membership in QLUB 
es entitle you to Psion software support ~ 

which is probably the best Hy to get speci- 

fic technical queries answered. 

They can be reached at; 

Psion Software Support 


22 Dorset Square 
_ London Ni 


QLUB News 


News of the World 


— but also a whole new set of features, lis- 
tings and reviews from QL World. 


The QLUB Editar - who was complai- 
ning he didn’t get enough sleep while ha- 
ving to produce one QLUB News every two 
months — is also happy with the arrange- 
ment as it gives you more information than 
he currently has room to offer. So we came 
to the agreement with QL World and obtai- 
ned six months’ worth of free QL World 
jssues for you, our members, and arrang- 
ed for it to be distributed with QLUB 
News. 


Not only will you continue to receive 
QLUB News, but you also get a new glos- 
sy magazine free with your QLUB News 
every issue - and the first issue of QL World 
is enclosed with this issue. 


| QLETTERS 


Any Commercial 
Use? 


Thave enjoyed using the QL for many busi- 
ness SE and I think it has great 
potential. But does it have any great value 
in the commercial market? 

If security protocols — passwords, or en- 
cryption facilities — were available, then I 
think it would have an outlet in firms and 
offices, : 

But commercial enterprises will be wary 
of it so long as strangers are capable of 
breaking and entering. I would only buy an 
accounting package for the QL if the data 
created was safe from outside interference. 


'N Silver 


London ECL 


Editor's reply: Many small businesses in 
particular do not require the high levels of 
information security demanded by the lar- 
ie corporations. Since most QL software 

s been aimed at. such users, the software 
houses have not given such a high priority 
to security. 

Maybe your letter — and letters like it - 
will inspire them to develop security- 
oriented financial software. 

In addition to the standard software 


Please write... 


You'll note that there is a word- 
processing package called QL Quill 
included with your QL. Un- 
beknown to you, that word-process- 
ing package was not put there for 
you to write reports, business let- 
ters and other such trivia — but was 
solely included for the purpose of 
writing letters to the Editor of 
QLUB News. 


Said editor was been recently un- 
derwhelmed by the volume of mail 
coming into these offices and has de- 
cided to point this little-known fact 
out to you. He would also like to add 
that letters written with old- 
fashioned pen and paper (or even ty- 
pewriter) are also acceptable. 


So, if you have anything to say 
about QLUB, QLUB News or the 
QL, please write to him (he's a lonely 
man) at; 


Editor 

QLUB News 
Sinclair Research 

25 Willis Road 
Cambridge CB1 2AQ 


‘lock-outs’ the QL’s ROM cartridge port 
could be used as a sort of physical key to 
sensitive data. And only those with top 
clearance would have a HOM cartridge to 
‘unlock’ sensitive data. But again, i all 
depends on demand. 


WELCOME TO 
THE QLUB 


This is the first newsletter that you, as a 
new QLUB member, will receive over the 
next twelve months. 

Psion Software Support Limited supply a 
comprehensive support service on QL Aba- 
cus, Archive, Easel & Quill, Qdos, Super- 
BASIC and any related peripherals - eg. 
Printers or memory expansion boards. Psion 
may be contacted by telephone on (1-723 
0558 or by writing to: 


Psion Software Support 
22 Dorset Square 
LONDON NW1 


your attention. 


This issue there are several types of 
software — including leisure software and 
utilities. Here's a sample: 


® You can now count on your QL for help 
in the season’s planting with QL Gardener 
by Gardian Computing Services, Even the 
QL Editor - a self-confessed pink thumb — is 
hoping this program will finally help turn it 
a little green. 

QL Gardener is a plant-matching and se- 
lection program, suitable for use by ama- 
teurs, professionals and students. The data- 
base contains 25000 pieces of information on 
more than 1100 species. Users can specify 
up to 22 characteristics ranging from soil to 
environmental factors - from which to 
search for their ideal plant. 

For example, you could search for a yel- 


low flowering shrub for borders, which 
grow in an acidic soil. It is also possible to 
add your own plant data and additional ‘plant 
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SOFTWARE UPDATE 


When this page started last year, we were able to give you 
detailed descriptions of a few new QL software products 
each issue. Then we had to have a special pull-out Software 
Update to accommodate all the new releases. And now there 
are so many new QL software titles that we can select only 
some of the most interesting each month and bring them to 


data files’ will be available from the authors. 
The comprehensive manual wes written by 
professional horticulturalists and the pro- 
gram is compatible with floppy disks. This 
is quite simply the most powerful program 
of its kind currently available. The retail 
price will be £24.95. 


® But if you're determined to stay inside, 
and want to do some heavy-duty program- 
ming, the QL Macro Assembler by GST has 
to be the flavour of the month for you. 
Tt promises to be one of the most substan- 
tial program development tools available 
for the machine and is a must for every 
serious QL software developer. The pro- 
gram will retail at £59.95 and will be 
available in the near future. 


= Equally important for programmers is 
the long-awaited C programming language 
developed by Lattice and distributed by 


Software Specials 


————— — —— — Se 


To order DIRECT FROM SINCLAIR RESEARCH Ltd: By mail: complete the coupon below. By telephone: please phone 0276 


685311 9am-5pm, Monday — 


Metacomco (who are featured in this issue’s 
Qorporate QLose-up). You'll find this ver- 
sion of C has all the power you would expect 
from a 6800-family implementation and 
should allow you the room to develop the 
tools you need. It will sell for £99.95. 


mw The highly-structured (and much- 
favoured) Pascal programming language 
has also been developed for the QL by Me- 
tacomco. To provide you with the maximum 

ce for your data, part of the program is 
supplied on a ROM cartridge which slots 
into the back of the QL. Both this program 
and the C compiler will be available later 
this summer. Contact Metacomco for 
details at 26 Portland Square, Bristol, 
BS2 8RZ. 


x = a 


Despite the growing number of S 
for the QL, Sinclair ee is keen to 
further broaden the choice of quality enter- 
tainment software. If you have software _ 
you think could be of publishable quality, 
send it to; 


Games Software Editor 
QLUB News 

25 Willis Road 
Cambridge 

CBI 2A 


Friday (remember to have your credit number at hand). 


The following titles are available at a 20% discount franf this issue of QLUB: QL Monitor (QLUB price £19.95), QL Toolkit 
(QLUB price £19.95), and QL Assembler (QLUB price £31.95). 
Other software immediately available from Sinclair Research includes QL Chess, QL Touch ‘n‘ Go, QL Cash Trader, 
QL Project Planner, QL Decision Maker and QL Entrepreneur. 


Qty Item 


Rem Price Total 


*Please delete/complete as applicable 


Please tick if you require a VAT receipt 0 


*I enclose a cheque/postal order payable to Sinclair Research Ltd. for £ 
*Please charge to my Access/Barclaycard/Trustcard No. Poe 


Signature 


Name: Mr/Mrs/Miss 


Address| | | | 


be 


Send to Sinclair Research Ltd., FREEPOST, Camberley, Surrey GU15 3BR 


_ this summer. — 


DW 


Things have been bullish on 
the QL hardware front this 
spring with disk drives see- 


_ ming to sprout out of every 


corner and modems lurking 
among the ads in every new 
QL magazine. : 

Probably the biggest news is the announ- 
cement of an official QL printer, to be sold 


The printer will provide output for 


graphics as well as text and offers both 


draft and near-letter-quality printing 


modes. 


It is manufactured for Sinclair by a well- 

own printer company, and is designed to 
‘hook-up-and-go' with the QL. It is moulded, 
of course, in QL black and will fit in nicely 
with existing QL monitor. 


Meanwhile, the communications options 
for the QL have taken a competitive turn — 
with two ue both announcing and 

vering mi systems. The first is the 

QCOM communications system, which has 

been acquired by established modem manu- 

facturers Tandata Marketing - following 

the collapse of OE Limited, which had origi- 

i oo ore the hardware component of 
em. 


Tandata also acquired the rights to 
communications software developed by Sci- 
con fer the QCOM system. Sinclair Re- 
search software ee Alison Maguire 
was integrally involved in the modem ‘res- 
cue’ operation and says the modem is very 
important for the QL. 

“The QCOM range of communications 
products has always been viewed as a vital 
element in opening up the QL's full, profes- 


“The QCOM range of communications products 

has always been viewed as a vital element in 

opening up the QL’s full, professional use. We 

are delighted with the commitment Tandata has 

shown in realising the QCOM range’s commer- 

cial potential.” - Sinclair Research software 
manager Alison Magtire 


/ARE UPDATE 


sional use. We are delighted with the — 
commitment Tandata has shown in realising — 
the QCOM range’s commercial ie 

Although it is under no legal obligation to 
do so, Tandata is contacting all OEL eusto- 
mers who had placed orders, with a view to 
offering them a special package. 

The Tandata modem will be competing 
with a new modem system from Modem 
House — who currently own the rights to 
market the famous Spectrum VTX5000 
Prestel modem. Modem House’s ‘Bright 
Star’ will feature Prestel access, terminal 
emulation and a parallel printer port. 

STOP PRESS! It’s just been announced 
that Sinelair Researeh will be offering own- 
label disk drive and interface units for the 
QL. Details are sketchy so far, but the plan 
is to offer two 3.5 inch 720K drives (with a 
total storage capacity of 1.4 Megabytes) and 
a disk interface for less than £500. 

The system is designed and manufactu- 
red for Sinclair by MicroPeripherals and 
allows full integration with Qdos. More de- 
tails on this as they become available. 


PSION PROBLEM BOX 


Problem: How to design QL Archive 
data files with large numbers of fields. 
Answer: DISPLAY only prints the 
fields of a data file that it can fit on the 
work area. INSERT and ALTER only 
work with the fields visible on the work 
area. To use a data file with more fields 
than DISPLAY will print, you will 
need to design a screen or screens with 
SEDIT. A small procedure to swap 
between ser is a useful timesaver. 
LET KEYS$="2” 
WHILE KEYS$()"q” 
PRINT AT 14,0;"PRESS A/B TO 
SWAP SCREEN [Q TO QUIT)” 


LET KEYS$=LOWER 

(GETKEY()) 

IF KEY$="A”:SLOAD “SCREE- 

NA”:ENDIF 

IF KEY$ ="B”: SLOAD 

“SCREENB”:ENDIF 

ENDWHILE 

As INSERT and ALTER work only 

on visible fields, it is useful to group the 
fields in the data file that are most fre- 
quently changed on one screen. If 
“SCREENB” contained the fields to be 
changed, sclecting that sereen and ty- 
ping ALTER would allow the visible 
fields to be changed. To include the 


ALTER command in the above proce- 
dure add the line: 

IF _KEY$="C”:SLOAD “SCREEN- 
B”:ALTER:ENDIF 
into the WHILE loop. Another good way 
to pick out particular fields which you 
want to change is to use the SINPUT 
and UPDATE. If there is a field in the 
data file called name$ - and name$ has 
been included in the screen design - then 
SINPUT name§ will move the cursor to 
the location of that field in the screen 
design and allow that field to be chan- 
ged. UPDATE writes the changed 
fields to the data file. 
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Let’s put it in simpler terms. An array is 
a set of variables which are best considered 
as parts of a whole. Each of the variables in 
the set has the same ‘type’, which means 
that each variable in an integer array is an 
integer, each variable in a string array is a 
string, and so on. When we declare an ar- 
ray, we give it a single name (the ‘identi- 
fier’). To be able to manipulate all the diffe- 
rent variables inside the array, we must 
follow this identifier with a number (or 
numbers) in parenthesis. This number is 
known as the subscript, 


Take an example; suppose this declara- 

tion was found in a program: 
100 DIM a(s) 

This line declares an array of six floating- 
point variables identified as a whole by ‘a. 
Two questions immediately come to mind. 
Why six variables, and why are they floa- 
ting point? The DIM statement, which de- 
clares the array and reserves space inside 
the machine for its contents, creates enough 
space to cater for all the elements of ‘a’ from 
0 to 5. This is different from the ZX Spec- 
trum, which would have created an array of 
only five elements. 

he variables inside the array are floa- 
ting point variables for the same reason 
that a normal variable called ‘a’ would be. 
Unless specifically told otherwise, the 
SuperBASIC interpreter will make all iden- 
tifiers floating point. This isn’t important at 
the moment. 

Now that the array ‘a’ exists, it is easy to 
put values into each element of the array, 
and just as easy to find out what those 
values are. We put a value into a particular 
element by using the number of the element 
as the array subscript: 


QLUB News 


Programmers forum 


If you are a new SuperBASIC programmer, you may have asked yourself what an array is, and 
what can it be used for. If you wanted to be terribly formal, you could say that an array is a ‘set 
of inter-related variables each of the same data type; each member of the set being accessed by 
the same identifier, subscripted by an index’. The problem with this is that it’s almost meaning- 
less to anyone but a computer scientist. 


a(3) = 23 

This sets element number 3 to 23. Re- 
member that the first element of an array is 
subscript 0. If we use a subscript te access 
an element which doesn’t exist, 

a(13) = 56 
the program will stop with an error. 

‘To get the value of an array element, you 
use exactly the same syntax, but on the 
right-hand side of an expression rather than 
the left: 

print a$(1) 
You can be really clever with arrays by 


String arrays are a special case. They are 
declared in the same way, using the ‘S’ suf- 
fix to specify string variables: 

100 DIM b§(20),c83,15) 

This declares a string array called ‘b? 
and a two-dimensional aa array called 
‘eS’. The last dimension specified in a string 
array declaration (or the only one in the 
ease of a one-dimensional array) is used to 
specify the length of each strmg in the ar- 
ray. This means that, from our declaration 
above, b$ is a string variable of fixed length 
(20 characters), and ef is an array of four — 


es» 


iving them more than one dimension. The 
Hinensed is the number specified in the 
DIM statement which declares the array. If 
you put two numbers in the declaration, 
100 DIM b(4,8) 
then you create a two-dimensional array 
called ‘b’. Probably the best way of looking 
at this is to consider it as a set of arrays. 
Our declaration above creates what is effec- 
tively five arrays of nine floating point va- 
riables, all of which are accessed using ‘b’ 
and two subscripts: 
b(0,0) 
accesses the first element of the array re- 
presented by b(0), You can go much further 
than two dimensions, but each added di- 
mension multiplies the number of bytes of 
memory required by the array. 


string variables, each of which is 15 charac- 
ters long. Element 0 of the last dimension in 
a string array does exist, but should not be 
accessed as it is used to hold the string 
length. 


Uses of arrays 

Arrays are particularly useful whenever 
you want to store and manipulate numerous 
items which are related. As a typical, if _ 
unexciting example, consider an ennai: 
database management system. Hach em- 
ployee has a name, an address, a pay num- 
ber and a salary. It seems eminently sen- 
sible to keep all this information in a group 
of arrays, so that a particular employee’s 
record can be accessed by using the same 
subscript on each individual array. 


a 
‘Unless specifically told otherwise, the 
~ SuperBASIC interpreter will make all identifiers 
floating point.’ 
eT 
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Qorporate QLose-up: 
Meeting Metacomco 


Metacomeo, the Bristol-based system 
software house which recently develo- 
ped the C and Pascal programming Jan- 
guages (among others) for the QL, has a 
long history of participation in the personal 
computer market. 

The company's tirst major software 
project in the micro field was to work with 
Digital Research (mventors of the well- 
known CP/M business operating system) in 
developing that company’s Personal Basie. 
‘The original Basic source was sold by Meta- 
comeo to DR and then emerged as Personal 
Basie. 

That was a few years ago and since then 
Metacomeco has built a range of languages 


Lisp graphics: SNOWFLAKE 


Two BCPL source code files being edited 
concurrently with the clock running as 
a third task. 


and development products - it now includes 
Pascal, Basic, Lisp, Fortran, BCPL, 
editors, linkers, a multi-tasking operating 
system and a language dedicated to artifi- 
cial intelligence. 

Not all the company’s work is in system 
software. It has one interesting sideline ai- 
med at reducing work involving algebraic 
equations for astronomers, mathematicians. 

Until the QL products, most of Metacom- 
co’s work was on an OEM (Original Equip- 
ment Manufacturer) basis and they weren't 
known in the home computer market. It 


specialises — apart from Basie — in software 
for the 68000 processor family. 


Metacomco took up development for the 
68000 about 18 months ago - 


The QL Assembler was launched first - 
and Metacomeo says there was a strong 
demand for it - then BCPL, LISP and then 
Pascal. 

Aside from QL product development and 
releases, Metacomco still maintains a rela- 
tionship with Digital Research and still pro- 
motes the Metacomeo TRIPOS multi- 
tasking operating system — on which it is 
working to improve the user interface. 


reise 


features = record 


An assembler source code file and a 
Pascal source code file being edited si- 
multaneously. 


An assembler source code file and the 
corresponding output listing from the 
assembly being edited concurrently. 


x Inside the Sinclair QL, by Jeff Naylor 
and Diane Rogers, £6.95. A guide to the 
inner workings of the QL, with some useful 
illustrated programs. 

* Artifical Intelligence on the Sinclair 
QL, by Keith and Steven Brain, £6.95, This 
book helps your QL get to grips with Artifi- 
cial Intelligence and make it an orator, a 
teacher, even a pupil. All this including AI 
routines, 

* Assembly Language Programming on 
the Sinclair a. by Andrew Pennell, £7.95. 
An introduction to machine code explaining 
how the QL uses its 68000 family processor 
and includes a collection of proven progam 
routines for immediate use. 

* Essential Mathematics on the Sinclair 
QL, by Czes Kosniowski, £6.95. Provides 
basic programming routines including an 
explanation of all the mathematical routines 
and illustrations in short programs. Packed 
with maths information. 

* Developing Applications for the Sin- 
clair QL, by Malcolm Davison, £7.95, 
Using examples drawn from years of busi- 
ness and home applications, this guide un- 
leashes a host of powerful QL software bu- 
siness and home applications. 

* Introduction to Simulation Techniques 
on the Sinclair QL, by John Cochrane, 
£6.95. An introduction to the Sinclair QL’s 
Simulation Techniques. 


* Practical Software for the Sinclair QL, 
by David Lawrence, £6.95. This solid intro- 


| | QLUB News | 
OFF THE SHELF 


To help QL owners get an idea of the books currently available we’ve compiled this list. 


TIM HARTNELL'S 


duction to useful programming is a library 
of working Teun ae eshniaties 
and detailing an entire collection of applica- 
tions programs using a modular format. 

* The Sinclair QL Companion, by Boris 
Allen, £6.95. 

* Exploring the Sinclair QL, by Andrew 
Nelson, £4.95. 

+ Mathematics on the Sinclair QL. Exa- 
mines the use of mathematical signs inclu- 
ding COS ,ABS ,AND, SGN, in writing 
programs with specific reference to the QL. 


These mathematical utilities are illustrated _ 


in short programs which can be integrated 
into larger ones. 

* The Working Sinclair QL, by David 
Lawrence. A more general book explaining 
eomputer applications in areas such as ft 
nance, tax, information storage, graphics, 
musi¢ and education. 

x QL Superbasic, by A. A. Berk, £5.95. 
Following the usual fare for teaching the 
QL’s special dialect of Basic/SuperBASIC, 
this book offers an additional chapter on 
Microdrive storage and handling, plus an 
appendix on system commands. 

*& QL Computing, by Ian Sinclair, £5.95. 
Examines the facilities the machine offers 
and provides programs demonstrating them 
covering graphics, sound, database applica- 
tions and fault finding. 

* Sinclair QL Adventures, by Tony 
Bridge and Richard Williams, £5.95. Write 
your own adventure with this book using its 


specially devised Generator program. 

x Advanced Graphics Routines for Your 
Sinclair QL, by Alan Rudge, £6.95. Learn 
how to take full advantage of the QL’s gra- 
phies facilities with this useful guide. 

* Basic Programming on the QL, by 
Neil Cryer and Pat Cryer, £7.95. Beginning 
with fundamentals, this book provides a 
comprehensive, illustrated course on QL 
SuperBASIC, After mastering this you can 
move on to more complex tasks and test 
everything learned with the suggested acti- 
vities and sample programs. 

* The QL Book of Games, by Richard G. 
Hurley and David D. Virgo, £6.95. You ean 
build your own games library and key-in 
the programs while learning how to oper- 
ate the SuperBASIC with this guide. 

* QL Superbasic: A Programmer's 
Guide, by John Wilson, £6.95. Chapters co- 
ver the SuperBASIC’s features focusing 
on Structure, Procedures and Functions, 
Condition Testing, Repetition Control, Ar- 
rays, Strings, the QL Display, Sound, Ti- 
ming, Filing and User Friendliness, 

* The Sinclair QL Series. This series is a 
collection of five books designed to help you 
get the most from your QL: 


Introducing the Sinclair 

Introduction to SuperBASIC on the 

Sinclair QL. £6.95 
Advanced Programming with the Sinclair 
Desk Top Programming with the Sinclair 
Gb £6.95 
Word Processing with the Sinclair QL £6.95 


SEE 


* QL Advanced User Guide, by Adrian 
Dickens, £12.95, A complete guide to Qdos 


- and the Sinclair QL, it covers multi-tasking, 


transient programs, resident procedures, 
heaps and stacks, traps and utilities, and 
68000 assembler programming. All 


_ programs are also available on Microdrive 


cartridge. : 3 
* Quantum Theory; A Guide to the 


_ Sinclair QL, by Jeremy San, Fouad Katan 


and Simon Rockman, £5.95. Provides a 
down-to-earth practical guide to learning 


_ SuperBASIC and QL programming. 


* QL SuperBASIC: The Definitive 
Handbook, by Jan Jones, Written by the 
designer and writer of Sinclair's QL 
SuperBASIC language, this book is far 
more than a detailed description of 
commands. It provides an explanation of 


_ the language’s structure and its design. For 


the beginner it demonstrates the elegance, 
speed and efficiency of the QL’s power. 


* QL SuperBASIC: A Programmer's 
Guide, by John Wilson, £6.95. Gives 
programmers a good understanding of the 
differences between the SuperBASIC and 


* QL Assembly Language Programming 
by Coe Opie, £6.95. Intended for use with 
McGraw Hill's program editor/68000 
assembler package costing £29.95, this is an 
advanced, technical guide to 68000 
assembly language. 


* QL Games Compendium, by Tim 


Hartnell, £6.95. Twenty-three games listed 
under Adventure, Artificial Intelligence, 
_ Board Games, Deduction and Perception. 


_* A QL Compendium, by Gandoff and 
King, This is a collection of QL program 
listings published by Addison-Wesley. 
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* QL Abacus, by Spottiswoode. A 
guide to using Abacus spreadsheets. 

* Quick QL Machine Language, by 
Giles. This hook teaches the basics of 
how to program your QL in machine 


ae 

* QL Quill, by Simon and Spottiswoode. 
A how-to guide for using the QL Word 
Processor. 

* QL Easel, by Spottiswoode. A how-to 
for QL Graphics. 

* QL SuperBASIC by A.A. Berk. For 
the neophyte QL SuperBASIC user. 

* QL Gamesmaster, by Kay Ewbank, 
Mike James and S.M. Gee, £7.95. A 
well-presented compromise between the 
basic programmers’ guide and a book of 
advanced programs. 

* Getting to Know Your Sinclair QL, by 
Stephen Morris, £7.95. For the nervous or 
novice user, pre-manual guide to the QL 
providing real nuts and bolts stuff. 

* Exploring Artificial Intelligence on 
Your Sinclair QL, by Tim Hartnell, £6.95. 
Ahighly readable and painless 
demonstration of the AI techniques 
discussed. Also includes a discussion of 
learning and reasoning concepts, and a look 
at Expert systems, the fast-growing 
offshoot of Al. 


EXPLORING 
ARTIFICL 
AL | INTELLIGENCE 


SINCLAIR QL 
‘Tim Hartnell 


‘Getting to Know Your Sinclair QL. . , isa 
book for the nervous or novice user’ 


* QL Handbook, by Tim Hartnell. This 
is a general guide to the QL computer. 


Professional and Business Uses of QL, 
by Lewis. A basic guide for the QL business 
user. 

& The C Programming Language, by 
Brian Kerninghan and Dennis Ritchie, 
£22.95, Written by the man who created C 
and implemented it on the Unix operating 
system on Digital Equipment Corporation’s 
PDP-11 computers, this is a guide for keen 
programmers casting around for - 
information on the subject. 


* Learning to Program in C, by Thomas 
Plum, £15.95. Not intended for home users, 
this guide is designed to turn the reader 
into a competent programmer ina real 
software environment. 


* Logie, Algebra and Databases, by 
Peter Gray, £9.95. Examines the 
applications of logic programming and 
applications programming to database 

ugh the database query languages; this 
guide is aimed at students, postgraduates 
and programmers interested in the topic. 


* 68000 Assembly Langua; 
Programming, by Kane, Harkins, 
Levanthal, £19.50. 


All the SuperBASIC graphics procedures, such as LINE, CIRCLE and POINT, lie the use of 
_ graphics on the QL extremely simple. If you decide to delve into machine code, you'll caae a 


all the graphics routines have their origins in assembly language, as each procedure is availa 
near enough, by calling yarious parts of Qdos into play. 


Listing 1 


oa you an took at the aeons of 
@ Qdos graphics routines in the # A (very) simple graphics 
Technical Gude things look depressingly staple reyes. see by-Mlay Banting 
difficult — floating ae co-ordinates, RI SE 300 
stacks and channel IDs. 
It’s nothing like so difficult as it seems, STACK QU -50 
though. Once you understand the concepts 
inv ived, you'll find yourself writing gra- TO.OPEN EGU 1 
phies routines in machine code almost as RILEXEC EGU $110 
ay as you would write them in Super- RILFLOAT EU a 
SIC. SD.LINE  EQU $31 
ae graphies routines are all part of the MT.FRIOB EGU 5 
_ ‘redirectable 1/O system’, which is accessed _ 
_ via the 68000 TRAP #8 instruction. Before BRA.S START 
executing this instruction you must put a DOL 0 
yalue into register D0 which tells the sys- DCW | SAAFB 
_ tem exactly what action to take. The codes DCW 8 
_ We are interested i in here are shown below: DCB "GRAPHICS" 


LEA.L —SCR_NANE, AO 
HOVEO 40,03 
Value Routine Name Action : HOVEO = A-1,D1 
NOVEO #10, OPEN, DO 
TRAP 42 


$0. SD.POINT Plots a point 
SD.LINE Draws a line 
SD.ARC Draws an are 


LEAL CO_ORDS,A2 
LEAL STACK(AS) ,Al Make Al into’ Ab-rel ative RI stack pointer 


MOVER #3,D1 We're going to convert 4 ints to fps 


a CONVERT SUBQ.L = #2, AL make room for integer 
SD-ELPIS Draws an ellipse MOVE.W — (4214,0(Rb, 01.) 


ane HOVE.W — RILEYEC,A3 Convert to Floating point - let ad0s 
SD.SCALE Sets graphics scale HOVER —-#RI_FLOAT,DO do all the hard work! 
i JR AS) 
SD.GCUR Sets graphics cursor DBRA DL, CONVERT Repeat for all four integers 


TRAP LL Tell TOSS the addresses are Aé-relative 


(Che '$’ means that the numbers are in #50. LINE,DO Draw the line ? 
hexadecimal) yun eeetake your tise 
___ Apart from having one of these values in 
~ D0, the routines also require three other 40,03 Sue .gut duan ‘saat: 
pieces of information. The first is held in etl 
register D3, and is known as the timeout. BoA 
_ This tells the routine how long it must wait 
_ before it returns with failure. If the process 
carried out by the routine cannot be comple- 
ted in this time, the routine returns 
with error ‘not complete’. The time is mea- co ORDS 1 . 
sured in units of 20ms, so a timeout of 50 % ‘ a Veco orddnatan of Line start 
corn nds i echand: We can put a spe- oe. X,Y co-ordinates of line end 
cial value in D3, -1, which means ‘nfinite 
timeout’ and causes the routine to return 
_ only when it has completed its task. 


SCR_NAME 


and mo 


The second bit of information is the chan- 


nel ID, This is the internal number used by _ 


Qdos to identify uniquely each open chan- 


nel. It has nothing at all to do with the # 


numbers used by the SuperBASIC inter- 

weter to identify its channels. This number 
is returned by the Qdos routine which opens 
channels, assuming it succeeded, and is al- 
most always required in register A0. The 


. te routines are no exception. 


, each of the routines needs a poin- 


~ ter toi arguments, These arguments are 


held on a special type of stack, called the 
‘Arithmetic or ‘RI’ stack. As stacks go, 
there is nothing unusual about it except 
that register AJ is used as the stack poin- 
rand, as things can move about in memo- 
ry from time to time, the value held in Al is 
relative to A6. This means that although Al 
can be considered as the RI stack pointer, 
the actual value of an argument will be 
found only by using Al as an index to A6: 
Real SP = 0(A6,A1.L) 
$0 


top_of stack value = 0(A6,A1.L) 


It is not this AG relative value of the RI 
stack pointer which needs to be passed to 
the graphics routines, though. These need 
the RI stack pointer in register Al to be 


absolute. We'll see later that we can alle- 
_ viate the problem of some routines needing 
_ AG relative and others not by taking advan- 


tage of another Qdos routine invoked by 
TRAP #4, | 
_ Sounds trivial so far, doesn’t it? Things 


“are complicated a little (well OK, a lot) by 


the fact that the arguments to each of the 


graphies routines must be in internal floa- 
: ae format. : 
ere’s no easy way of calculating the — 
internal representation of a given number, 
_ but once a 
— Solong as 


Qdos ean come to our aid. 
e numbers we want to convert 
are whole numbers between -32768 and 


32767 (Le. 16-bit integers), we can use a 


dos routine called RI.EXEC to convert 
the number into floating point format for 


RILEXEC is not invoked by a 68000 


TRAP instruction, as it is a vectored rou- 
__ tine. This means that the symbol RI. EXEC 
_ equates to the address of a vector. Inside 


this vector is the address of the routine 
itself. The normal way of ae a vectored 
routine is to put the address of the vector 


_ into an address register and then execute a 


JSR (An) instruction. 
RLEXEC performs a number of opera- 


_ tions, most of them on floating point num- 


bers, but it can also do a few conversions. 
‘The code representing the operation is put 
into register DO before the call and the RI 


stack pointer (A6 relative) must be in re- 


pister Al. After the call, the RI stack poin- 


~ ter is updated to point to the result of the 
__ operation, D0 holds the error code (0 means 
~ success), and all the other registers are pre- 


served. 
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Listing 2 


# Another {very) siaple graphics demo by Adam Denning 
* This time using ‘random’ nuabers to draw lines all over the place 


SIZE 
STACK Eau 


TO,0PEN = EQU 
RIEXEC = EQU 
RILFLOAT QU 
SD.LINE £OU 
SD.SETIN EQU 


BRA.S 
OC.L 
OC.W 
OCW 
DC.B 


LEAL 
MOVE 
MOVED 
MOVES 
TRAP 


AGAIN LEAL 
MOVER 


CONVERT —BSR.S 
SUBQ.L 
ANDI.W 
MOVE.W 
MOVE. W 
MOVEQ 
ASR 
DBRA 


TRAP 


MOVED 
MOVE 
TRAP 


BSR.S 
MOVE. W 
MOVE 
TRAP 


BRA.S 


RANDOM = MOVE.L 
ROL.L 
MOVE.L 
EOR.L 
ROR. 
RTS 


SCR_NANE DCW 
DC.B 


END 


300 
50 


1 
Siic 
8 
$31 
$29 


START 

9 

S4AFB 

8 
“BRAPHIC2’ 


SCR_NANE ,A0 
40,13 
#-1,D1 

#10. 0PEN,DO 
n 


STACK (AS) ,AL 
43,01 


RANDOM 
42,01 

487F D4 
D4,0(Ab ALL) 
RI.EXEC, A 
4RI_FLOAT, DO 
(a2) 

D1 , CONVERT 


4 


45D, LINE,DO 
41,03 
8 


RANDOM 

D401 

49D, SETIN, DO 
8 


AGAIN 


(Ad) +,D4 
43,04 
(A3) +, D5 
D5,D4 
45,04 


4 
“ser. ' 


Make Al into Ab-relative RI stack pointer | 
We're going to convert 4 ints to fps 


get random nuaber 

make room for integer 

less randoa than before? 

stack random nuaber 

Convert to floating point - let OD0S 
do all the hard work! 


Repeat for all four integers 
Tell 1055 I love her... 
Draw the line 

asetake your tise 


the bastard corrupts Al 


change the ink to a random colour 


and do it all over again 


hopeless ‘algoritha’, but it'll do 
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Machine Code > 


The RILEXEC operation we are interest- 
ed inis called RIL_FLOAT, which converts 
a 16-bit signed integer on the RI stack to 
the corresponding floating point number, 
An integer takes up two bytes, while a floa- 
ting point number takes up six, so the RI 
stack pointer (A1) will be four less than it 
‘was prior to the call. 

Let’s put all this theory to work now by 
writing a very simple program to draw a 
line somewhere on the sereen. Such a pro- 
gram would use the SD.LINE routine, 
which needs the following parameters on 
the RI stack: 

$00(A1) Y co-ordinate of line end 
$06(A1) X co-ordinate of line end 
$0C(AL) Y co-ordinate of line start 
$12(A1) X co-ordinate of line start 

Asthe Y co-ordinate of the end of the line 
is the last thing on the stack (think about 
it), we can stack things in the logical order 
of (X,Y) start of line, (X,Y) end of line. 

Listing ] is one way of implementing our 
example program. Notice that we set the 


the RI stack. We create an ad hoe RI stack 
in the job's data area, using a negalive off- 
set from A5. When a job is first started, 
register AG is set to point to the beginning 
of the job, and 0(A5,A6.L) points to the end 
of the job’s data space. Ab is therefore rela- 
tive to A6, so -50(A5) is also relative to A6. 
Al is now our RI stack pointer. 

Each integer co-ordinate occupies two 
bytes on the RI stack, so 2 must be subtrac- 
ted from Al each time an integer is stacked. 
‘The thus-stacked integer is then converted 
to internal floating point format by 
RLEXEC. D1 controls a DBRA loop to 
convert and stack all four co-ordinates. 
Once the loop has exited, the RI stack is 
almost ready for SD,LINE. The only pro- 
blem is that, as was said earlier, the gra- 
phies routines need A1 to be absolute rather 
than A6 relative. This could be solved by 
adding A6 to Al with ADDA.L A6,A], but 
we may as well take advantage of another 
Qdos routine. Whenever TRAP #4 is exe- 
cuted, it makes the next W/O routine 


With the QL Technical Guide in one hand 
and a QL Assembler in the other, you can draw 
circles, arcs, blocks, borders and so on 
with very little effort. 


program’s data space size to 300 bytes here, 
as the Qdos documentation says that at 
least 240 bytes must be available on our RI 
stack whenever one of these routines is 
called. 

The first thing the program does is to 
open a screen channel for itself so that we 
can actually see the line it’s going to draw. 
The open is done by loading register AO 
with the address of the name of the device 
to be opened (SCR.’), putting -1 into D1 (to 
signify ‘open for this job’) and 0 into D3, D3 
is used to indicate the type of channel open 
required (read only, write only, overwrite, 
etc.). Finally, the value of IO.OPEN (1) 
must be put into register DO and a TRAP 
#2 instruction executed. The routine re- 
turns with the channel ID allocated in AO if 
there were no errors. Our program as- 
sumes that there have been no errors. 

The rest of the program draws the line. 
First, each of the four co-ordinates must be 
converted into floating point numbers on 


(anything invoked by TRAP #3) consider 
any addresses passed to it to be relative to 


_ Onee the line has been drawn, the job is 
killed with the MT.FRJOB manager trap. 

When the program has been assembled, it 
can be run with either EXEC or EXEC W. 


The other program here, shown in listing 
2, is a bit more ambitious. It continuously 
draws random lines in random colours. 


Much of the code is the same as the pre- 
vious sample but each co-ordinate is calcu- 
latd randomly. The subroutine which does 
this RANDOM is by no means a true ran- 
dom number generator. In fact, it only 
plays around with a couple of numbers and 
would not normally be useful for any pur- 
pose requiring ‘more random’ numbers. 
Nevertheless, it suffices here. Four random 


numbers between 0 and $7F are stacked at 


atime, and then SD.LINE is called to draw 
the line. After each line has been drawn, 
RANDOM is called again to get a new value 
for the sereen’s ink colour, and the TRAP 
#3 routine SD.SETIN is called to perform 
the colour change. The program then loops 
to do it all over again, hopefully with 
different random numbers. : 
With the QL Technical Guide in one — 

hand and a QL Assembler in the other, you 
can draw circles, arcs, blocks, borders and 
so on with very little effort. 
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Quarks 


The most difficult peripheral. The reviewing skills of the QLUB staff were recently 


_over-taxed with the arrival of a device which didn’t plug into the QL’s expansion port, used 


no electricity, had no accompanying software - but was still decorated in beautiful QL 


black. It was a dustcover. 


Actually, it was dustcover number one to ; 


pe through our office doors. In our first 
our primary criterion — does it fit the QL? 
We were left scratching our heads — either 
our QLs have been using steroids or they 
must have a pretty funny ruler back at the 
factory. 

Dusteover number two which promptly 
arrived to replace dusteover number one — 
sent back until it grew enough — proved to 
be aperfect fit. 


Unfortunately, this did not solve the pro- 
blem of the review - what remotely interes- 


__ ting things can you say about a dustcover? 
_ It probably has about as much literary ap- 


peal as a dissertation on a shoehorn. 


Well, we can tell you it’s black and it 
keeps out the dust while it covers the QL. 
The only other thing we can add is that it 
was the first of a number of QL dustcovers 


we were to see. They range in price from 
~ £3.50 to £5.95 - but try them before you 


buy. 


nchtest, this particular dusteover failed 


range 


WHAT THE PAPERS SAY: A rather in- 
teresting advert popped up recently in a 
popular weekly computing magazine which 
shall remain nameless: 

FOR SALE: Sinclair QL with ungra- 
zed quilt, £800 or offers? 


A smart 
book buy? 


We recently came across the smartest- 
looking book for the QL — this one should 
easily qualify for entrance into the MENSA 
QL Users’ Library. The title of this airy 
tome: Artificial Intelligence on the QL by 
Keith and Steven Brain. 


QL mast 
storage 


For those of you who would like something 
a little different for this year's holiday — 
why not try a Weymouth company’s new 
packaged extravaganza — a computing 
windsurfing holiday? Don't ask how or why, 
but we'd like to hear from any survivors. 


SPECIAL OFFER OFFICE 


The Special Offer Office keeps track of all 
deals and discounts for QLUB members — 
which ineludes anybody who is sent this 
_ newsletter, Listed below are the deals offe- 
red to members; 

* Metacomco is planning a special limi- 
ted offer for QLUB members on its deve- 


lopment and programming software. For 


more details, write before August 15 to: 


Metacomco offer 
Special Offer office 
26 Portland Square 
Bristol, BS2 8RZ. 


* GST Computer Systems is offering its 
acclaimed 68K/OS operating system for the 
QL at an attractive discount. For details, 
write to GST Computer Systems, 8 Green 
St., Willin, widge CB4 5JA or 
telephone Jane Pateman on (0954) 81991. 
Have your membership number and ad- 
dress to hand. 


A 20 percent discount is available on 
selected items of QL software sold by 


Sinclair Research through QLUB. 

QL Monitor + QLUB price £19.95. 

bb Assembler — QLUB price £31.95 
Toolkit - QLUB price £19.95 


Send your order using the form on page 
3 to Sinclair Research, Stanhope Road, 
Camberley, Surrey or telephone on (0276) 
685311. 


* A discount is available for a year’s 
subscription to EMAP’s QL User maga- 
zine. A full year’s subscription including 
delivery would normally cost £15. If you 
subscribe through QLUB, the magazine 
will be delivered for an all-in (postage inclu- 
ded) price of £11.50. To receive your 12 
issues, send a cheque or money order for 
£11.50 to PRQL, Subscription Department, 
QL User, Priory Court, 30/32 Farringdon 
Lane, London EC1. 


* Westway software is offering its new 
machine-code areade game - EVA - at a 
discount to QLUB members. The game nor- 
mally sells for £10.95 — but QLUB memhers 


can buy it for £1 off that price. Send your 
orders to Westway, 24 Preston Road, 
Lytham, Lancashire. 


NEXT ISSUE 


— More machine code 
— Printer details 
— Disk system examination 


— Psion problem page 


